home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / diskutil / ffind_10.lzh / FFIND_10.DOC next >
Encoding:
Text File  |  1989-07-04  |  14.0 KB  |  265 lines
  1.  
  2.  FEB. 14, 1989                    INSTRUCTIONS                         PAGE 1 
  3. ------------------------------------------------------------------------------
  4.  
  5.  
  6.             ********************* PLEASE NOTE ********************
  7.             *                                                    *
  8.             *  FILEFINDER DISKETTE CATALOGUER AND THIS DOCUMENT  *
  9.             *                                                    *
  10.             *  ARE COPYRIGHT MATERIAL DISTRIBUTED AS SHAREWARE   *
  11.             *                                                    *
  12.             ****************************************************** 
  13.  
  14.      What this means to you:
  15.      1 - You get to test the program before you pay for it.
  16.      2 - You get quality software at a very low price.
  17.      3 - You can make unlimited backups and distribute the programs to 
  18.          friends, provided no changes to the program or documents are 
  19.          made.  No copy protection and no risk to the purchaser.  
  20.                     (If you don't like it, don't pay!)
  21.  
  22.      What this means to the authors:
  23.      1 - We save expensive and costly packaging and distribution.
  24.      2 - We support our users directly, not through a middleman.
  25.      3 - We risk everything!  If you don't pay for the programs you 
  26.          use, we starve.  The hours spent in writing and debugging the 
  27.          software are down the drain!  Our families keep saying "I 
  28.          told you so!"  Finally, we give up on the shareware concept
  29.          in disgust and distrubute our work through a middleman.  You
  30.          loose!  You pay more for the same quality software.  You must 
  31.          try to get support from a corporate giant.  Good Luck!
  32.  
  33.                              SO PLEASE REGISTER
  34.  
  35.      Why should you register:
  36.      1 - You will have the satisfaction of not causing us to be 
  37.          ridiculed by our families.  (Thank You!)
  38.      2 - You will be advised of any updates to the program and will be 
  39.          provided these free if you send a disk.  A nominal $5 postage
  40.          & handling and disk charge will be made if disk not included.
  41.      3 - Any problems will be dealt with by the program authors, not 
  42.          someone who doesn't care.
  43.      4 - All this only costs 15 bucks! (Cheap at twice the price!)
  44.  
  45.                                   THANK YOU !
  46.  
  47. ------------------------------------------------------------------------------
  48.  
  49.                     REGISTRATION FORM FOR FILEFINDER v1.00
  50.  
  51.  
  52.    NAME:____________________________________________ POSTAL CODE:____________
  53.  
  54.  STREET:_____________________________________________      UNIT#:____________
  55.  
  56.    CITY:____________________________________________  PROV/STATE:____________
  57.  
  58.  
  59.     TO REGISTER, SEND $15 TO:  Al Hubbard, (1 of the hopefull authors)
  60.        (AND THIS FORM)         3281 Hornbeam Crescent
  61.                                Mississauga, Ontario  L5L 1B5
  62.  
  63.  
  64. ------------------------------------------------------------------------------
  65.  FILEFINDER Copyright 1988 by Ian Morrison & Al Hubbard          Version 1.00 
  66.  
  67.  
  68.  FEB. 14, 1989                    INSTRUCTIONS                         PAGE 2 
  69. ------------------------------------------------------------------------------
  70.  
  71.                                   INTRODUCTION
  72.  
  73.      Did you ever have trouble finding a program or lose a file on one of your 
  74. many disks?  Did you ever have trouble distinguishing between similar program 
  75. names or have too many duplicate files?  Well, if you are like me you can 
  76. answer "YES!" to these questions.  The solution: a diskette cataloguer.
  77.  
  78.      FILEFINDER is the easiest, most full featured, fun to use cataloguer you 
  79. can find!  It was written to fill a void in the Atari ST world.  Yes, there 
  80. are other disk cataloguers out there, but all of them left us longing for one 
  81. which is fun, easy to use, and complete.   FILEFINDER will catalogue your 
  82. disks and the files they contain.  It will display ALL files, even hidden or 
  83. system files.  It will show you these file attributes, as well as the time of 
  84. creation and size of each file.  It will enable you to keep track of all these 
  85. program and data files and find them when required.  It will perform searches 
  86. of the catalogue so you can find that long lost file, or distinguish amoung 
  87. files of similar names.   It will display any of it's information to the 
  88. screen or print it for a permanent record.  It runs in medium resolution on 
  89. any Atari ST computer with color monitor.  It names and catalogues both single
  90. and double sided disks into any number of 75 disk catalogues.  It's easy GEM 
  91. operation is entirely RAM based and exceptionally fast.  We also think it's 
  92. interesting and fun to use!  It's just what the doctor ordered!
  93.  
  94.  
  95.                                PROGRAM OPERATION
  96.  
  97. Program Start
  98.  
  99.      Running the program is as simple as GEM can make it.  Just put the disk 
  100. in any drive and double click on the file FILEFIND.PRG.  It will go through 
  101. it's opening contortions, finishing up on the main menu.  At this point the
  102. menu selections are limited.  You can QUIT, read the ABOUT and INTRODUCTION
  103. screens and can SET CLOCK if it's not correct.  You may also SHOW or PRINT 
  104. DIRECTORY.  This displays or prints any disk directory, including a RAM drive
  105. or a hard drive.  The only stipulation for a hard drive, though, is you are
  106. limited to 200 entries.  Any more than this will not be read. Remember, this
  107. is a floppy disk cataloguer, not a hard drive maintenance program.  The 
  108. feature to read any disk is handy if you want to check what is on a disk 
  109. before adding it to the catalogue or check to see what catalogue files may be
  110. on the drive.  You may also NAME DISK at this point.  This feature allows you 
  111. to add or change the disk name label.  This is normally only allowed under GEM 
  112. when you format a disk.  With FILEFINDER you can change this information 
  113. anytime, without reformating the disk and losing all the files on it. The
  114. other options available now are LOAD or START a catalogue.
  115.  
  116.  
  117. Catalogue Start-up
  118.  
  119.      Using the LOAD or START catalogue menu selections is the way to actually 
  120. start using FILEFINDER.  You can only START a catalogue the first time you use
  121. the program.  When this selection is made, the program will supply a dialogue 
  122. box for you to type the desired name for the catalogue.  It allows editing of
  123. your input and will not allow any characters to be used which GEM does not 
  124. recognize in filenames.  Once the DONE box is selected (and a filename 
  125. defined) the program exits to the main menu.  It will now allow you to add a 
  126. disk to the catalogue.  If a previous catalogue was loaded from disk with the 
  127. LOAD selection, it will also exit to the main menu and make the appropriate
  128. menu selections available.
  129.  
  130. ------------------------------------------------------------------------------
  131.  FILEFINDER Copyright 1988 by Ian Morrison & Al Hubbard          Version 1.00 
  132.  
  133.  
  134.  FEB. 14, 1989                    INSTRUCTIONS                         PAGE 3
  135. ------------------------------------------------------------------------------
  136.  
  137. Adding a Disk
  138.  
  139.      You can add a disk any time a catalogue has been designated or loaded and 
  140. it doesn't have more than 75 disk already in it.  Once you select ADD DISK you 
  141. are prompted to insert a disk into the active drive.  If the presently active 
  142. drive is anything other than A or B, you are prompted to change to one of 
  143. these drives.  This prevents trying to load a RAM or hard drive directory into 
  144. the catalogue.  One note here.  Any time the program displays the DRIVE 
  145. SELECTOR dialogue box, it will accept a mouse click on the desired letter or 
  146. the drive letter typed from the keyboard to change drives.  If the desired 
  147. drive letter is already highlighted, just hit return.
  148.  
  149.      The disk is now checked for a label.  If it doesn't have one you are 
  150. advised of this and asked for a name.  FILEFINDER uses this name to store and
  151. recall the disk's information, so you cannot add a disk to the catalogue 
  152. without naming it.  Once the disk is named it adds it to the catalogue.  If 
  153. it's already in the catalogue, it will ask for confirmation of your desire to 
  154. update the present disk information in the catalogue.  After all this, the
  155. disk contents are in the catalogue and can be searched, displayed, or printed.
  156.  
  157.  
  158. Show, Print, or Delete Disk
  159.  
  160.      Individual disks contents in the complete catalogue can be acted upon by 
  161. selecting SHOW, PRINT, or DELETE DISK.  When these options are selected, a 
  162. listing of all the disks presently in the catalogue will be displayed on the 
  163. screen.  By pointing and double clicking on the desired disk name the selected 
  164. action iscarried out.  Remember, the black file used as the title always 
  165. displays the action you selected from the main menu.  This lets you know at
  166. all times what operation you are doing and prevents needless errors.  If SHOW 
  167. DISK is selected, the complete directory, including all contents of all 
  168. sub-directories, is shown on the screen.  Each screen requires a click to 
  169. continue so nothing is scrolled past too fast for you to read.  When PRINT 
  170. DISK is selected, the same complete directory is printed, and when DELETE DISK 
  171. is chosen, the selected disk information is permanently deleted from the 
  172. catalogue.  If DELETE or PRINT is selected, you must confirm the operation.
  173. This is one of the many ways FILEFINDER is made essentially error proof.  You 
  174. have to try (or ignore all warnings) to lose any information.
  175.  
  176.  
  177. Print, Show File Locations
  178.  
  179.      This is the heart of the program.  Once you have all your disks loaded to 
  180. the catalogue file, you may search the catalogue for any filename.  When one 
  181. of these options is selected, the program will ask you for the name to search 
  182. the catalogue for.  This name may be any number of allowable GEM filename 
  183. characters up to the maximum (8 in name, 3 in extension) which may be in a 
  184. filename.  Once DONE is selected and a search name has been selected the 
  185. search begins.  It's fast, so don't be fooled into thnking nothing happened!
  186.  
  187.      Any filename or directory name which contains the characters you have 
  188. entered will be displayed or printed.  By careful selection of the characters
  189. to search for, you can narrow down the search to find just the files you are 
  190. interested in.  For example you may enter .PRG to find all program files in 
  191. the catalogue or .BAS to find all files with an extension of .BAS.  All info 
  192. will be properly formatted on the screen or printer for easy viewing.
  193.  
  194.  
  195.  
  196. ------------------------------------------------------------------------------
  197.  FILEFINDER Copyright 1988 by Ian Morrison & Al Hubbard          Version 1.00 
  198.  
  199.  
  200.  FEB. 14, 1989                    INSTRUCTIONS                         PAGE 4 
  201. ------------------------------------------------------------------------------
  202.  
  203. Print Catalogue
  204.  
  205.      This feature allows you to print the complete catalogue.  It also allows 
  206. you to select a portion of the catalogue by choosing the disk to start and 
  207. stop with.  This allows you to keep a printed record of all your disk 
  208. directories, updating it only when a disk has changed.  You do not have to 
  209. print the whole catalogue every time.
  210.  
  211.  
  212. Save or Update Catalogue
  213.  
  214.      The only two options we haven't discussed in FILEFINDER are SAVE or
  215. UPDATE CATALOGUE.  These should be almost self-explanatory.  Select SAVE 
  216. CATALOGUE to save your catalogue to the disk of your choice.  UPDATE CATALOGUE
  217. allows you to change the information contained in the catalogue.  It reads the 
  218. disk you have inserted in the drive, searches the catalogue for this disks 
  219. entry, and replaces the catalogue information with the current disk contents.
  220. This makes it very easy to keep your catalogue accurate.  It is surprising how
  221. fast you can update 75 disks in the catalogue.  Without this ease of updating,
  222. a disk cataloguer is not of much use.  It's value rests in the catalogue being
  223. current.  By easily and regularly updating your disk entries, the use of a
  224. disk cataloguer can be made pleasant and invaluable.
  225.  
  226.  
  227.  
  228.                                    CONCLUSION
  229.  
  230.      FILEFINDER should be of use to anyone owning an Atari ST Computer.  These 
  231. machines are an excellent tool for most of us and help us organize our records 
  232. and life.  Unfortunately you can only be as organized as your filing system
  233. and the information it contains.  By making this information easily accessible
  234. and usable, FILEFINDER helps make things just a little more pleasant and 
  235. efficient for all of us.
  236.  
  237.  
  238.                              ADDITIONAL INFORMATION
  239.  
  240.      In programming FILEFINDER, some deliberate decisions were made.  One of 
  241. these was to make the program and current catalogue RAM based.  This makes all 
  242. catalogue maintenance and searches extremely fast.  This also involved a 
  243. compromise.  Each catalogue can hold a maximum of 75 disks.  This shouldn't be
  244. a problem.  You may have as many separate catalogues on disk as you like. Each
  245. can be loaded and saved easily as you work on them or adjust their contents.
  246. This helps your disk organization by forcing you to break up your disk records
  247. into obvious parcels.  Programs, data, games, etc. would be examples of this.
  248.  
  249.      Memory is not a problem with FILEFINDER.  Even an Atari 520ST has enough
  250. room for 75 double sided disk unless the disks have an extraordinary number of
  251. files on them or more than a couple of desk accessories are running at the 
  252. same time.  Even if memory is low you can still use FILEFINDER.  You will only
  253. be limited in the size of catalogue you can create or load.
  254.  
  255.      When a Desk Accessory is called, the screen may be a mess after running
  256. it.  This will happen if the DA does not clean up after itself.  The screen 
  257. will be cleaned up as soon as you call a menu item.  The cause for this is GFA
  258. Basic not cleaning up the screen after an accessory runs.  We could have
  259. turned off your accessories, but felt it was best to allow you to use them,
  260. even though it may cause a temporary mess.
  261.  
  262. ------------------------------------------------------------------------------
  263.  FILEFINDER Copyright 1988 by Ian Morrison & Al Hubbard          Version 1.00 
  264.  
  265.